home *** CD-ROM | disk | FTP | other *** search
/ Workbench Designer 2 / Workbench Designer 2.iso / time / clockdaemon / timezone.doc < prev   
Encoding:
Text File  |  1996-05-09  |  3.6 KB  |  98 lines
  1. Timezone strings:
  2. -----------------
  3.  
  4. This is a description of valid timezone strings for ENV[ARC]:TZ:
  5.  
  6. "XPG3TZ - time zone information"
  7.  
  8. The form of the time zone information is based on the XPG3 specification of
  9. the TZ environment variable.  Spaces are allowed only in timezone
  10. designations, where they are significant.  The following description
  11. closely follows the XPG3 specification, except for the paragraphs starting
  12. **CLARIFICATION**.
  13.  
  14. <std><offset>[<dst>[<offset>],<start>[/<time>],<end>[/<time>]]
  15.  
  16. Where:
  17.  
  18. <std> and <dst>
  19.     Are each three or more bytes that are the designation for the
  20.     standard (<std>) and daylight savings time (<dst>) timezones.
  21.     Only <std> is required - if <dst> is missing, then daylight
  22.     savings time does not apply in this locale.  Upper- and
  23.     lower-case letters are allowed.  Any characters except a
  24.     leading colon (:), digits, a comma (,), a minus (-) or a plus
  25.     (+) are allowed.
  26.  
  27.     **CLARIFICATION**  The two-byte designation `UT' is permitted.
  28.  
  29. <offset>
  30.     Indicates the value one must add to the local time to arrive
  31.     at Coordinated Universal Time.    The offset has the form:
  32.     <hh>[:<mm>[:<ss>]]
  33.  
  34.     The minutes <mm> and seconds <ss> are optional.  The hour <hh>
  35.     is required and may be a single digit.    The offset following
  36.     <std> is required.  If no offset follows <dst>, daylight savings
  37.     time is assumed to be one hour ahead of standard time.    One or
  38.     more digits may be used; the value is always interpreted as a
  39.     decimal number.  The hour must be between 0 and 24, and the
  40.     minutes (and seconds) if present between 0 and 59.  Out of
  41.     range values may cause unpredictable behavior.    If preceded by
  42.     a `-', the timezone is east of the Prime Meridian; otherwise
  43.     it is west (which may be indicated by an optional preceding
  44.     `+' sign).
  45.  
  46.     **CLARIFICATION**  No more than two digits are allowed in any
  47.     of <hh>, <mm> or <ss>.    Leading zeros are permitted.
  48.  
  49. <start>/<time> and <end>/<time>
  50.     Indicates when to change to and back from daylight savings
  51.     time, where <start>/<time> describes when the change from
  52.     standard time to daylight savings time occurs, and
  53.     <end>/<time> describes when the change back happens.  Each
  54.     <time> field describes when, in current local time, the change
  55.     is made.
  56.  
  57.     **CLARIFICATION**  It is recognized that in the Southern
  58.     hemisphere <start> will specify a date later than <end>.
  59.  
  60.     The formats of <start> and <end> are one of the following:
  61.  
  62.     J<n>    The Julian day <n> (1 < <n> < 365).  Leap days are not
  63.         counted.  That is, in all years, February 28 is day 59
  64.         and March 1 is day 60.    It is impossible to refer to
  65.         the occasional February 29.
  66.  
  67.     <n>    The zero-based Julian day (0 < <n> < 365).  Leap days
  68.         are counted, and it is possible to refer to February
  69.         29.
  70.  
  71.     M<m>.<n>.<d>
  72.         The <d>th day, (0 < <d> < 6) of week <n> of month <m>
  73.         of the year (1 < <n> < 5, 1 < <m> < 12), where week 5
  74.         means `the last <d>-day in month <m>' (which may occur
  75.         in either the fourth or the fifth week).  Week 1 is
  76.         the first week in which the <d>th day occurs.  Day
  77.         zero is Sunday.
  78.  
  79.         **CLARIFICATION**  Neither <n> nor <m> may have a
  80.         leading zero.  <d> must be a single digit.
  81.  
  82.         **CLARIFICATION**  If <dst> is given then <start>
  83.         and <end> are required - there is no `implementation
  84.         specific default'.
  85.  
  86.     <time> has the same format as <offset> except that no leading
  87.     sign (`-' or `+') is allowed.  The default, if <time> is not
  88.     given is 02:00:00.
  89.  
  90.     **CLARIFICATION**  The number of hours in <time> may be up
  91.     to 167, to allow encoding of rules such as `00:00hrs on the
  92.     Sunday after the second Friday in September'
  93.  
  94. Example (for Germany):
  95. ----------------------
  96.  
  97. MET-1MEST,M3.5.0,M9.5.0/03
  98.